+ HowTo: Wiki-разметка

[[toc]]

++ Что это такое
Это искусственный язык разметки гиппертекста. Он на порядок легче HTML, имеет низкий порог вхождения, удобночитаем и легок в поддержке.

++ Зачем она нам
Wiki-разметка используется главным образом для поддержания единообразие страниц сайта. Также она упрощает оформление текста, так как она гораздо проще HTML, имеет удобночитаемый вид. После изучения всех возможностей этой разметки и работы с ней некоторое время, вы станете удивляться, как же вы обходились без нее раньше.

++ Описание основных элементов разметки
Ниже приведены примеры использования разметки и результаты их выполнения.

+++ Заголовки
<code>
+++ Уровень 3. Заголовок
++++ Уровень 4. Заголовок
+++++ Уровень 5. Заголовок
++++++ Уровень 6. Заголовок
</code>
+++ Уровень 3. Заголовок
++++ Уровень 4. Заголовок
+++++ Уровень 5. Заголовок
++++++ Уровень 6. Заголовок

+++ Абзацы
<code>
Первый абзац.
 
А это уже второй абзац.
</code>

Первый абзац.

А это уже второй абзац.

+++ Списки
++++ Маркированные
<code>
* элемент списка
* элемент списка
 * вложенный элемент списка
 * вложенный элемент списка
* элемент списка
</code>
* элемент списка
* элемент списка
 * вложенный элемент списка
 * вложенный элемент списка
* элемент списка

++++ Нумерованные
<code>
# элемент списка
# элемент списка
 # вложенный элемент списка
 # вложенный элемент списка
# элемент списка
</code>
# элемент списка
# элемент списка
 # вложенный элемент списка
 # вложенный элемент списка
# элемент списка

++++ Смешанные
<code>
# элемент списка
# элемент списка
 * вложенный элемент списка
 * вложенный элемент списка
# элемент списка
</code>
# элемент списка
# элемент списка
 * вложенный элемент списка
 * вложенный элемент списка
# элемент списка

+++ Ссылки
<code>
http://www.site.com
[http://www.site.com Внешняя ссылка]
[./admin Внутренняя ссылка]
</code>
http://www.site.com
[http://www.site.com Внешняя ссылка]
[./admin Внутренняя ссылка]

+++ Изображения
<code>
http://upload.wikimedia.org/wikipedia/ru/6/65/EinsteinA.jpg
[http://upload.wikimedia.org/wikipedia/ru/6/65/EinsteinA.jpg Эйнштейн]
</code>
http://upload.wikimedia.org/wikipedia/ru/6/65/EinsteinA.jpg
[http://upload.wikimedia.org/wikipedia/ru/6/65/EinsteinA.jpg Эйнштейн]

+++ Таблицы
<code>
|| Cell 1 || Cell 2 ||
|| Cell 3 || Cell 4 ||
</code>
|| Cell 1 || Cell 2 ||
|| Cell 3 || Cell 4 ||

<code>
||< left ||= center ||> right ||
|| The quick brown || fox jumps over || the lazy dog. ||
</code>
||< left ||= center ||> right ||
|| The quick brown || fox jumps over || the lazy dog. ||

<code>
|| lines must start and end || with double vertical bars || nothing ||
|| cells are separated by || double vertical bars || nothing ||
|||| you can span multiple columns by || starting each cell ||
|| with extra cell |||| separators ||
|||||| but perhaps an example is the easiest way to see ||
</code>
|| lines must start and end || with double vertical bars || nothing ||
|| cells are separated by || double vertical bars || nothing ||
|||| you can span multiple columns by || starting each cell ||
|| with extra cell |||| separators ||
|||||| but perhaps an example is the easiest way to see ||

+++ Горизонтальная линия
<code>
----
</code>
----

+++ Содержание
Генерирует содержание данной статьи на основе заголовков. Содержание содержит ссылки для быстрого перехода к каждому заголовку.
<code>
[[toc]]
</code>

Пример содержания можно увидеть в начале данной статьи.

+++ Центрирование текста
Любая строка, начинающаяся со знака "равно".
<code>
= Строка по центру
</code>
= Строка по центру

+++ Выделения
<code>
**Bold** ''italic'' {{teletype text}} //emphasis// __underline__
</code>
**Bold** ''italic'' {{teletype text}} //emphasis// __underline__

+++ Цвет текста
<code>
##ffca00|Оранжевый текст##
</code>
##ffca00|Оранжевый текст##

+++ Разрыв строки
Состоит из пробела и знака подчеркивания. Ставится в конце строки. Используется когда часть текста нужно перенести на новую строку, не создавая новый абзац и не разрушая разметочный блок.
<code>
* элемент списка #1
* элемент списка #1
* элемент списка #1, следующий текст которого должен распологаться _
на новой строке
* элемент списка #1
</code>
* элемент списка #1
* элемент списка #1
* элемент списка #1, следующий текст которого должен распологаться _
на новой строке
* элемент списка #1

Иначе список разобьется на два:
<code>
* элемент списка #2
* элемент списка #2
* элемент списка #2, следующий текст которого должен распологаться
на новой строке
* это уже элемент списка #3
* элемент списка #3
</code>
* элемент списка #2
* элемент списка #2
* элемент списка #2, следующий текст которого должен распологаться
на новой строке
* это уже элемент списка #3
* элемент списка #3

+++ Текст, который не нужно размечать
Текст, заключенный с обеих сторон двумя обратными кавычками, не будет рассматриваться на наличие в нем разметочных тегов. Используется чтобы экранировать сочитания символов, совпадающие с элементами разметки.
<code>
`` ++ = текст выведется как есть: [[toc]] **bold** ... etc. ``
</code>
`` ++ = текст выведется как есть: [[toc]] **bold** ... etc. ``

++ Примечание
Данная разметка может иметь отличия от других Wiki-разметок, в частности от MediaWiki, которая используется в Википедии. Также в разметку погут быть внесены корректировки по усмотрению администратора.